home *** CD-ROM | disk | FTP | other *** search
/ Programmer Plus 2007 / Programmer-Plus-2007.iso / Programming / Report Writers / Crystal Repot 9.0 Full CD version / Setup.exe / REDIST / EN / NSQL301A.EXE / Disk1 / Readme.txt < prev    next >
Encoding:
Text File  |  2002-01-17  |  8.8 KB  |  228 lines
  1. =======================================================================
  2.                        NotesSQL 3.01a 
  3.                  an ODBC Driver for Domino
  4. =======================================================================
  5. Licensed Materials - Property of Lotus and/or IBM
  6. (c) Copyright Lotus Development Corporation 1999 - 2001
  7. (c) Copyright IBM Corporation.  
  8. All rights reserved.
  9. US Government Users Restricted Rights - Use, duplication or disclosure
  10. restricted by GSA ADP Schedule Contract with Lotus and/or IBM Corp.
  11.  
  12. Lotus is a registered trademark of Lotus and/or IBM.
  13.  
  14. January 2002
  15.  
  16. For up-to-date product information, see http://www.lotus.com/notessql.
  17.  
  18.  
  19. ---------
  20. Contents:
  21. ---------
  22. 1. Installation Requirements and Details
  23. 2. Files Installed
  24. 3. Changes Since Release 3.01
  25. 4. Known Issues
  26. 5. Resolved Issues
  27.  
  28. ----------------------------------------
  29. 1. Installation Requirements and Details
  30. ----------------------------------------
  31.  
  32. To install and use NotesSQL, you need:
  33.  
  34. - An ODBC Driver Manager version 3.0 or later
  35. - One of the following:
  36.   - Microsoft Windows 95, 98, or 2000
  37.   - Microsoft Windows NT 4.0 or later with Service 
  38.     Pack 4 or later
  39. - One of the following, with a full user license:
  40.   - Lotus Notes Client release 4.6.4 or later
  41.   - Lotus Domino release 4.6.4 or later
  42.   - Lotus Notes Designer release 4.6.4 or later
  43.   - Lotus Domino Off-Line Services release 1.01 or later
  44.  
  45. For client-based third-party applications, NotesSQL and the Designer or 
  46. Desktop software must be installed on your local machine. For 
  47. server-based applications (for example, Microsoft Internet Information 
  48. Server), NotesSQL and any one of the versions above must be installed
  49. on the server.
  50.  
  51. Installation details:
  52.  
  53. This version of NotesSQL should have been installed automatically when
  54. you ran the self-executing installation file for your platform from the 
  55. NotesSQL Web page. If you need to reinstall NotesSQL, see "Installing
  56. NotesSQL" in the documentation.
  57.  
  58. The installation program checks for previous versions of the NotesSQL
  59. driver files and renames them to "*.30x" (where "x" is the specific
  60. version digit; for example, "nsql32.300"). In the unlikely event that 
  61. you need to use an earlier version of NotesSQL after installing version
  62. 3.01a, do the following:
  63. - To restore NotesSQL 3.0 or 3.01 driver files, simply rename the driver
  64. DLLs that were backed up during the installation of NotesSQL 3.01a. The
  65. 3.0 driver files will have the extension "*.300" in the NotesSQL
  66. directory; 3.01 driver files will have a "*.301" extension. Rename the
  67. appropriate files to "*.dll".  Your machine Data Sources will now use
  68. the old version of NotesSQL.
  69.  
  70. Note: We suggest that you back up your 3.01a files before restoring the
  71. older drive files.
  72.  
  73.  
  74. ------------------
  75. 2. Files Installed
  76. ------------------
  77. <Installation directory> // These files (including the DOCS directory
  78.      index.htm           // and its contents) may be in an earlier
  79.      notessql.nsf        // NotesSQL installation directory.
  80.      nsql301.log
  81.      NSQL32.dll
  82.      NSQLC32.dll
  83.      NSQLV32.dll
  84.      NSQLE32.exe
  85.      license.txt
  86.      Nsql_ALM.exe
  87.      nsql_alm.GID
  88.      nsql_alm.hlp
  89.      Readme.txt
  90.      UninDrv.dll
  91.      <Docs>
  92.           HTML and GIF files
  93.      <License>
  94.       Multilingual license files
  95.  
  96. <\Windows\system>
  97.      CTL3D32.DLL       // If not already installed
  98.      DS16GT.DLL
  99.      DS32GT.DLL
  100.      MSCPXL32.DLL
  101.      MTXDM.DLL
  102.      ODBC16GT.DLL
  103.      ODBC32GT.DLL
  104.      ODBC32.DLL
  105.      ODBCAD32.EXE
  106.      ODBCCP32.CPL
  107.      ODBCCP32.DLL
  108.      ODBCCR32.DLL
  109.      ODBCINT.DLL
  110.      ODBCTRAC.DLL       
  111.      MSVCRT40.DLL              
  112.         
  113.  
  114. -----------------------------
  115. 3. Changes since release 3.01
  116. -----------------------------
  117. See "Resolved Issues"
  118.  
  119.  
  120. ---------------
  121. 4. Known Issues
  122. ---------------
  123.  
  124. We are investigating the following problems and hope to fix them in a
  125. future release.
  126.  
  127. - You cannot currently use the NotesSQL ODBC dialogs in the ODBC 
  128.   Data Source Administrator to rename a file DSN. Instead, you must
  129.   rename the file manually or delete the file and recreate it with a
  130.   different name.
  131. - You may be unable to use a DSN to open a database on a remote AIX
  132.   server if, while using the NotesSQL ODBC dialogs to create the DSN,
  133.   you typed the database name (instead of selecting it from the list 
  134.   of databases on the server) and omitted the .NSF extension.
  135. - In some circumstances, you may not be able to access .nsf files in
  136.   subdirectories off of the Notes/Data directory on AS/400 Domino 
  137.   Server.
  138. - During NotesSQL configuration or at application run time, you may
  139.   sometimes be prompted for the password of the current user, rather 
  140.   than the password for the user (if any) specified in a DSN or an 
  141.   ODBC connection call. This is because NotesSQL needs to access a 
  142.   server to build a list of available databases. Specifically, you 
  143.   may encounter this prompt in the following circumstances:
  144.  
  145.   - During NotesSQL configuration: While using the NotesSQL ODBC setup
  146.     dialogs to create or modify a DSN that specifies a database on a
  147.     server
  148.   - At application run time: As the result of a call to 
  149.     SQLDriverConnect or SQLBrowseConnect that attempts to connect to
  150.     a database on a server
  151.  
  152.   In either situation, supply the password for the current user (the 
  153.   user whose Notes ID is listed in the local notes.ini file). This 
  154.   allows NotesSQL to access the server and build the list of available
  155.   databases. 
  156.  
  157.   (Note that you may still receive an additional password prompt
  158.   during a connection attempt. This is normal behavior that is part of
  159.   the Notes security model, and depends entirely on the correctness
  160.   of any user name and password information you supplied for the 
  161.   connection.)
  162. - Users of Lotus 1-2-3 Millenium Edition may experience 
  163.   problems when using the Query Table Assistant (Create - Database - 
  164.   Query Table) to access external tables. To avoid these problems, 
  165.   first select File - Addins - Manage Addins and make sure the 
  166.   dqaui.12a addin is checked. Then use the Query menu, instead of the
  167.   Query Table Assistant, to make queries.
  168. - You may encounter problems editing the names of user and system DSNs
  169.   if you have an incorrect version of the ODBC driver manager loaded. 
  170.   To avoid this problem, make sure you install the version provided 
  171.   with NotesSQL 3.0 or 3.01.
  172. - If you create an empty table (a table that has no fields) and you
  173.   attempt this SQL statement against that table (represented here by
  174.   "T1"):
  175.  
  176.        select *, NoteID from T1
  177.  
  178.   a crash occurs.
  179.  
  180.   Workaround:
  181.   Use any of the following statements to prevent the crash:
  182.  
  183.        select NoteID, * from T1
  184.        select * from T1
  185.        select NoteID from T1
  186.  
  187. - User cannot authenticate when Local DB with Enforce Consistant ACL,
  188.   and user is member of a group.
  189.   If you:
  190.   1. Create a new blank database Locally
  191.   2. Add a view and form
  192.   3. Add a group you are a member of to the ACL with Manager Access
  193.   4. Removed your Hierarchical name from the ACL
  194.   5. Set default to No Access
  195.   6. Turn on Enforce Consistent ACL
  196.   7. Add a DSN to this Local DB
  197.   8. Try to connect to this db using ODBC Test
  198.   You will receive an error that the user is not authenticated.  The
  199.   reason for this is that we are using the function NSFBuildNamesList
  200.   for authentication, and this function will not authenticate a username
  201.   in a local database against a server group (list of names).  
  202.   Workaround: add the hierarchical names of the users that need access
  203.   to the individual database to its ACL.
  204.  
  205. - Under some conditions, for example using ODBC test, the following
  206.   scenario may occur:
  207.    1. If you try to connect to a database but the connection fails to
  208.       occur through the DSN (for example, if the database doesn't exist
  209.       or if the database is on a server that is down), you should get
  210.       the error "[lotus][odbc lotus notes]file does not exist."
  211.    2. Click OK to clear the error dialog.
  212.    3. Now a bit of lag time may occur before control is returned to the
  213.       application, especially on slower machines, because NotesSQL is
  214.       still performing some processing. If you try to execute another
  215.       statement or close ODBC test during this period, a crash occurs:
  216.            The instruction at "0x1f7d8006" referenced memory at
  217.            "0x00000035". The memory could not be "written".
  218.   Workaround: wait for control to be returned to the application before
  219.   attempting to execute another statement or close the application.
  220.  
  221.  
  222. ------------------  
  223. 5. Resolved Issues
  224. ------------------
  225. NotesSQL 3.01a is a hotfix to address the issue with multiple user
  226. credentials in one instance of NotesSQL (SPR #RWIS4XVNHD). This fix
  227. requires the addition of the file NSQLE32.exe, installed into the
  228. NotesSQL directory.